home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload Trio 1 / Shareware Overload Trio Volume 1 (Chestnut CD-ROM).ISO / dir3 / vendor28.zip < prev    next >
Text File  |  1994-08-08  |  31KB  |  939 lines
  1. t" applied to them.
  2.  
  3. **  This option is case sensitive.  This means that "Secret", "secret" and
  4. "SECRET" are all different passwords.
  5.  
  6.                            See Also: "Using Data
  7.                            Encryption", PKZIP -s
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15. ════════════════════════════════════════════════════════════════════════════
  16. PKWARE Inc.                       PKUNZIP                                 53
  17.  
  18. _____________________________________
  19. -t   Test .ZIP file integrity
  20.  
  21. This option is used to test files within a .ZIP file in order to verify that
  22. they are valid and have not been corrupted.  PKUNZIP will perform all the
  23. actions that would normally be taken during a .ZIP file extraction, except
  24. that files will not be written to disk.
  25.  
  26. The data will be extracted and checked against the CRC to ensure it's val-
  27. idity. After each file is checked it's name will be displayed with an "OK".
  28.  
  29.    C:\PKSTUFF>pkunzip zc102 -t
  30.  
  31.    Searching ZIP: ZC102.ZIP - PKWARE Support BBS (414)354-8670
  32.    Testing: ZC.DOC        OK
  33.    Testing: ZC.EXE        OK
  34.    Testing: ORDER.FRM     OK
  35.    Testing: VER-HIST.TXT  OK
  36.  
  37. In this example a command is issued which performs a test on the .ZIP file
  38. "zc102". As each file is tested its name is displayed.  Note that the .ZIP
  39. file comment is displayed.
  40.  
  41. If you test a file that is not a .ZIP file, or specify particular files
  42. within the .ZIP file that do not exist, you will receive the message:
  43.  
  44.    PKUNZIP: (E11) No file(s) found.
  45.  
  46. Testing a .ZIP file with errors would produce a display something like this:
  47.  
  48.    Searching ZIP: PROBLEM.ZIP
  49.    Testing: WORLD.M~      PKUNZIP: (W15) Warning! file fails CRC check
  50.    Testing: CORELDRW.BPT  OK
  51.  
  52.    PROBLEM.ZIP has errors!
  53.  
  54. Normally, a CRC failure as above indicates that a file has been damaged
  55. either in storage or transmission.  For instructions on attempting to repair
  56. a .ZIP file that has been corrupted, see PKZIPFIX in the Trouble Shooting
  57. section.
  58.  
  59.                        See Also: "Trouble Shooting", "F.A.Q."
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71. ════════════════════════════════════════════════════════════════════════════
  72. 54                              PKUNZIP                              PKZIP 2
  73.  
  74.  
  75. _____________________________________
  76. -v[b][r,c|d|e|n|p|s][m]         View [brief] file information
  77. -vt[m]                          View Technical file information
  78.  
  79. The -v option for PKUNZIP is the same as the -v option for PKZIP, with one
  80. exception.  In PKUNZIP the `c' option for sorting refers to the CRC value.
  81. For PKUNZIP this option refers to the Comment of a file.
  82.  
  83. For complete information, please see the -v option in the PKZIP Command
  84. Reference.
  85.  
  86.                             See Also: PKZIP -v
  87.  
  88. _____________________________________
  89. -x<filespec>    Exclude files from extraction
  90. -x@list.lst     Exclude list of files from extraction
  91.  
  92. By specifying a -x as part of the PKUNZIP command, you may prevent a file or
  93. group of files from being extracted.  Using -x with a list file will allow
  94. you to exclude a list of files from extraction.
  95.  
  96.    pkunzip fd201.zip -x*.doc
  97.  
  98. In this example all files are extracted from the .ZIP file "fd201.zip" except
  99. for those with a ".doc" extension.
  100.  
  101. -x may be used more than once on the command line, and may be used in
  102. combination with specific filespecs and list files.
  103.  
  104.                              See Also: PKZIP -x
  105.  
  106. _____________________________________
  107. -$   Restore volume label
  108.  
  109. This command is used to restore any volume label that has been stored in the
  110. .ZIP file.  It is important to remember that the PKZIP command used to store
  111. a volume label does not store a drive letter along with the label.  Upon
  112. extraction, the volume label will be assigned to the target drive.
  113.  
  114.    C:\>pkunzip davebk.zip -$ a:
  115.  
  116. This example will extract the contents of "davebk.zip" to the A: drive.  If a
  117. volume label was stored as part of the .ZIP file, the volume label for the
  118. floppy in drive A: will be reset to the one contained in davebk.zip.
  119.  
  120.                              See Also: PKZIP -$
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127. ════════════════════════════════════════════════════════════════════════════
  128. PKWARE Inc.                       PKUNZIP                                 55
  129.  
  130. _____________________________________
  131. -@filename.lst     Generate LIST file
  132.  
  133. Please note that this option is different from using a list file.  When a
  134. list file is to be read by PKZIP there is no dash in front of the @.
  135.  
  136. Using this option will cause a list file to be generated using the specified
  137. file name instead of a normal PKUNZIP operation being performed.  The output
  138. file will be a plain ASCII file with one file name per line, and will be
  139. identical to the listing of files PKUNZIP would have extracted had the -@
  140. option not been used.
  141.  
  142.    pkunzip underdem.zip -@showme.lst
  143.  
  144. This would create a list file called "showme.lst" containing a list of all
  145. the files present within the .ZIP file.  File specs may be used in
  146. conjunction with this type of command, in the same manner as a normal
  147. extraction command.  Also the -e option may be used for sorting.  The
  148. following example creates an alphabetized list file of only the ".doc" files
  149. within it:
  150.  
  151.    pkunzip manuals.zip -en *.doc -@docs.lst
  152.  
  153. The extension of ".lst" on a list file is not mandatory, but recommended for
  154. clarity.
  155.  
  156.                            See Also: "Using List Files",
  157.                                  PKZIP @, -@
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183. ════════════════════════════════════════════════════════════════════════════
  184. 56                               PKUNZIP                             PKZIP 2
  185.  
  186. PKSFX/ZIP2EXE
  187. ════════════════════════════════════════════════════════════════════════════
  188.  
  189. The PKZIP utilities offer a self-extraction capability.  This means that you
  190. can make a .ZIP file into an .EXE file.  This file will in effect be able to
  191. extract itself. A  PKSFX (PK-Self Extracting) file consists of a .ZIP file
  192. which has been transformed into a self-extracting file by the utility
  193. ZIP2EXE. There is no utility or file called "SFX" or "PKSFX", but the
  194. self-extracting file will show PKSFX on the banner in the same manner as
  195. PKUNZIP:
  196.  
  197.    PKSFX (R)  FAST!  Self Extract Utility  Version 2
  198.    Copr. 1989-1992 PKWARE Inc. All Rights Reserved. PKSFX/h for help
  199.    PKSFX Reg. U.S. Pat. and Tm. Off.
  200.  
  201. Creating a Self-Extracting File
  202.  
  203. In order to create a self-extracting file, you must first create a .ZIP file.
  204. Once this .ZIP file is created, use the ZIP2EXE utility to transform this
  205. .ZIP file into an .EXE file.
  206.  
  207.    D:\>zip2exe test.zip
  208.  
  209.    ZIP2EXE (tm)     Self-Extract Creator     Version 2
  210.    Copr. 1989-1992 PKWARE Inc. All Rights Reserved. ZIP2EXE/h for help
  211.  
  212.    TEST.ZIP => TEST.EXE
  213.  
  214.    D:\>
  215.  
  216. As you can see, an .EXE file by the same name as the .ZIP file is created.
  217. The original .ZIP file is not deleted.
  218.  
  219. Meet Junior
  220.  
  221. **  Turning a .ZIP file into an .EXE file increases the size because of the
  222.     included extraction program.  The added size is approximately 13.5K
  223.     bytes. If space is at a premium, and you are willing to sacrifice
  224.     functionality for size, try PKSFX Junior(TM).
  225.  
  226. The PKSFX Junior is somewhat smaller, and offers very few command line
  227. options due to this reduced size.  The options which are available with
  228. the PKSFX Junior are indicated on the PKSFX command summary.
  229.  
  230. To create a PKSFX Junior file, add the command line option -j when performing
  231. the ZIP2EXE step.
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239. ════════════════════════════════════════════════════════════════════════════
  240. PKWARE Inc.                  PKSFX/ZIP2EXE                                57
  241.  
  242.  
  243.    D:\>zip2exe -j test.zip
  244.  
  245. **  PKSFX Junior adds approximately 3K bytes to the .ZIP file.
  246.  
  247. PKSFX Junior can handle a maximum of 512 files.  Although PKSFX Junior has
  248. this limit to the number of files it can handle, there is no limit to the
  249. file size.
  250.  
  251. PKUNZIP Junior
  252. ════════════════════════════════════════════════════════════════════════════
  253. PKUNZJR.COM
  254.  
  255. The PKUNZIP Junior program is an extremely small stand-alone extraction
  256. program.  It is used in the same manner as PKUNZIP but it has only the
  257. functionality of the PKSFX Junior self-extractor.
  258.  
  259.     PKUNZIP(R)  FAST!  Mini Extract Utility  Version 2
  260.     Copr. 1989-1992 PKWARE Inc. All Rights Reserved.
  261.     PKUNZIP Reg. U.S. Pat. and Tm. Off.
  262.  
  263. Usage:  pkunzjr [-o] filename[.zip] [output_path]
  264.  
  265. PKUNZIP Junior has one option, -o.  This option is the same as that for
  266. PKUNZIP (Senior).
  267.  
  268. PKUNZIP Junior accepts the .ZIP file name on the command line, and may
  269. optionally accept an output path.  PKUNZIP Junior cannot extract specific
  270. files, but must extract the entire .ZIP file.
  271.  
  272. PKUNZIP Junior cannot extract a file containing more that 512 files, and does
  273. not support multiple volume .ZIP files.
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295. ════════════════════════════════════════════════════════════════════════════
  296. 58                           Introduction                            PKZIP 2
  297.  
  298. PKSFX Command Summary
  299.  
  300. Command line syntax and options are the same as PKUNZIP.  The options listed
  301. below are offered by a self-extracting file.
  302.  
  303. Syntax:        pksfx [option] [d:\path] [file]* [file]*
  304.  
  305. PKSFX indicates the name of the self-extracting file you are executing.  No
  306. options are necessary if you wish to simply extract all files to the current
  307. directory.  If you wish to extract the contents to another directory,
  308. indicate the drive and/or path the files should extract to.  To extract only
  309. particular files, indicate the name(s) at the end of the command line.
  310.  
  311. Options:
  312.  
  313. @listfile.lst            Specify list of files for extraction*
  314.  
  315. -c[m]                    Extract to console*
  316.  
  317. -d                       Re-create directories stored in .ZIP file*
  318.  
  319. -l                       Display software license agreement*
  320.  
  321. -n                       Extract only newer files*
  322.  
  323. -o                       Overwrite existing files
  324.  
  325. -p[a|b][c][#]            Extract to printer*
  326.  
  327. -s<password>             Decrypt with password*
  328.  
  329. -t                       Test file integrity*
  330.  
  331. *Indicates options not available in the PKSFX Junior and PKUNZIP Junior
  332.  programs.
  333.  
  334. Options should be placed after the self-extracting files name.  If multiple
  335. options are used they must be separated by a space and each must have its own
  336. option indicator (either - or /).
  337.  
  338. All options behave in the same manner as they do with PKUNZIP, with one
  339. exception.  The -s option cannot accept keyboard entry.  A password entered
  340. with a self-extracting file must be able to be entered from the command line.
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351. ════════════════════════════════════════════════════════════════════════════
  352. PKWARE Inc.                  PKSFX/ZIP2EXE                                59
  353.  
  354.  
  355. Modifying a Self-Extracting File
  356.  
  357. A self-extracting file can be operated upon by PKZIP and PKUNZIP in a manner
  358. identical to normal .ZIP files.  You will need to specify the full file name
  359. including the EXE extension.
  360.  
  361.    C:\>pkzip test.exe -f d:\*.*
  362.  
  363. There is no difference between operating on a self-extracting file and a
  364. normal .ZIP file.
  365.  
  366. A Note About Self-Extracting Files
  367.  
  368. When you create a self-extracting file, you are adding a copy of the
  369. extraction code to that file.  Since this code duplicates the functionality
  370. of the PKUNZIP program, it makes sense to use the self-extractor only when
  371. PKUNZIP will not be present on the machine to extract the file.
  372.  
  373. If you create many self-extracting files for your own use, you will be using
  374. more space unnecessarily.  Therefore it is recommended that you only use the
  375. self-extracting capability when you are sending a file to someone that you
  376. know does not have a compatible PKUNZIP.
  377.  
  378. Stripping the PKSFX Code
  379.  
  380. You may have occasion to want to keep the contents of a self-extracting file,
  381. but wish to turn it back to a normal .ZIP file.
  382.  
  383. The ZIP2EXE offers an option to reverse the process.  This is done with the
  384. command line switch -e:
  385.  
  386.    F:\>zip2exe -e test.exe
  387.  
  388. ZIP2EXE will recognize normal and PKSFX Junior files automatically.
  389.  
  390. Sending a Self-Extractor
  391.  
  392. If you are sending a PKSFX file to somone who is not familiar with data
  393. compression and/or PKWARE products, we recommend you tell them to do the
  394. following:
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407. ════════════════════════════════════════════════════════════════════════════
  408. 60                           Introduction                            PKZIP 2
  409.  
  410. With PKSFX Junior:
  411.  
  412. 1) Create a temporary directory on the hard drive to hold the
  413.    files contained in the self-extracting file.
  414.  
  415.    C:\>md temp
  416.  
  417. 2) Change to the directory that was just created.
  418.  
  419.    C:\>cd temp
  420.    C:\temp>
  421.  
  422. 3) Place the diskette containing the self-extracting file into
  423.    the A: or B: drive. 4) Type the name of the self-extractor,
  424.    including the path to the floppy drive.
  425.  
  426.    C:\temp>a:test
  427.  
  428. With normal PKSFX:
  429.  
  430. 1) Place the diskette containing the self-extracting file into
  431.    the A: or B: drive and change to that drive.
  432.  
  433.    C:\>a:
  434.  
  435. 2) Type in the following;
  436.  
  437.    A:\>test -d c:\temp
  438.  
  439. You may also wish to create a batch file or text file on the floppy disk
  440. containing the above steps. The contents of the self-extractor will be placed
  441. into this temporary directory. They can then examine or move the files at
  442. their leisure.  The -d option ensures that any subdirectory information
  443. included will be re-created, and causes PKSFX to create the temporary
  444. directory for the user.
  445.  
  446. ────────────────────────────────────────────────────────────────────────────
  447. A site license is required by a corporation, company, educational
  448. institution, or governmental agency for use of PKWARE software on the total
  449. number of computers that will use the software.
  450.  
  451. Use of PKWARE programs for personal use is covered by your purchase of a
  452. single license for PKZIP.  A Distribution License is required by a
  453. corporation, company, educational institution or governmental agency to use
  454. PKWARE programs to facilitate the distribution of software to outside parties.
  455.  
  456. Please note that if a self-extracting file is used, a Distribution License is
  457. required, because PKWARE code is distributed in the form of the PKSFX program
  458. combined with the file(s) being distributed.
  459.  
  460. Please contact PKWARE for more information if you intend to distribute self-
  461. extracting files.
  462.  
  463. ════════════════════════════════════════════════════════════════════════════
  464. PKWARE Inc.                  PKSFX/ZIP2EXE                                61
  465.  
  466.  
  467. Confirm before extract
  468.  
  469. If a PKSFX file has a .ZIP file comment attached, this comment is displayed
  470. before the file is extracted.  By imbedding a Control-S character (Hex 13,
  471. ASCII 19), you can cause PKSFX to pause. The display will look like this:
  472.  
  473.    Searching EXE: XXXXX.EXE -
  474.    .
  475.    .
  476.    .
  477.    (ZIP file comment text)
  478.    .
  479.    .
  480.    .
  481.    Do you want to extract these files now (y/n)?
  482.  
  483. Press 'Y' to extract the files, 'N' o abort.  Note that the Control-S
  484. character is not displayed.  This control character may be located anywhere
  485. within the comment.
  486.  
  487. If the user aborts by pressing 'N', an exit code of  12 will be returned by
  488. PKSFX. PKSFX Junior will return an exit code of 8.
  489.  
  490.                               See: PKZIP -z for more
  491.                             information on .ZIP file
  492.                             comments, Appendix D for
  493.                          more information on exit codes.
  494.  
  495. Memory Requirements
  496.  
  497. The memory requirements for PKSFX are similar to those of PKUNZIP.
  498.  
  499. PKSFX Junior, and PKUNZIP Junior require a minimum of 50K RAM free, and a
  500. maximum of 64K RAM free.
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519. ════════════════════════════════════════════════════════════════════════════
  520. 62                           Introduction                            PKZIP 2
  521.  
  522. USING LIST FILES
  523. ════════════════════════════════════════════════════════════════════════════
  524.  
  525. PKZIP, PKUNZIP and PKSFX offer a powerful feature; list files.  List files are
  526. simply listings of files.  They are used to simplify command lines, and make
  527. repetitive tasks less troublesome.
  528.  
  529. List files can allow you to perform some complex tasks which otherwise would
  530. not be possible. List files can not only be read, but can also be created by
  531. PKZIP and PKUNZIP. Also, list files can be created and used by other programs,
  532. such as StupenDOS", PKZOOM" and PKZMENU".
  533.  
  534. PKZIP and PKUNZIP use List Files in two ways: files to be included and files
  535. to be excluded.  If a List File is being created, the contents will reflect a
  536. listing of those files which would have been added, deleted, extracted or
  537. listed during a normal PKZIP/PKUNZIP operation.
  538.  
  539. List File text may contain:
  540.  
  541. -> Comments
  542.  
  543. -> File Names
  544.  
  545. -> Wild Cards
  546.  
  547. -> Exact Path Names and Files
  548.  
  549. -> Drive Letters
  550.  
  551. List File text consists of plain ASCII.  These files may be created using any
  552. text editor which can produce plain ASCII files, sometimes referred to as "DOS
  553. Text".
  554.  
  555. All of the following lines would be valid in a List File:
  556.  
  557.    clowns.bmp
  558.    *.exe
  559.    project.*
  560.    MSLR????.QWK
  561.    ;This is a comment
  562.    emp\census.txt  ;This is also a valid comment
  563.    D:\data\february.wk1
  564.    D:\games\majong\*.*
  565.    D:\QWK\*.REP
  566.  
  567. A line in a list file is treated in an identical manner to files specified on
  568. the command line.  Note that only files and comments are valid in a list file.
  569. Both forward and backward slashes may be used in a list file.
  570.  
  571.  
  572.  
  573.  
  574.  
  575. ════════════════════════════════════════════════════════════════════════════
  576. PKWARE Inc.                  Using List Files                             63
  577.  
  578.  
  579. Reading List Files
  580.  
  581. A list file can be used in two different ways with PKZIP and PKUNZIP:
  582.  
  583. -> Files to be acted upon in a ZIP operation.
  584.  
  585. -> Files to be excluded from a ZIP operation.
  586.  
  587. List files are usually specified with an @ (ASCII 64, normally above the 2 on
  588. your keyboard).  The list file character can be changed by modifying the
  589. configuration file.  Please note that the list file generation option (-@))
  590. will also change to the selected list file character.  Avoid using a character
  591. already used for another option.
  592.  
  593. The simplest example of using a List File is when a .ZIP file is going to be
  594. created containing the files specfied. If a List File called "test.lst" was
  595. created containing the following lines:
  596.  
  597.    *.COM
  598.    300Z.TXT
  599.  
  600. And then used in a PKZIP command:
  601.  
  602.    C:\>pkzip sample.zip @test.lst
  603.  
  604. All .COM files in the current directory would be added to the .ZIP file
  605. "SAMPLE.ZIP", as well as the file "300Z.TXT" if it existed.
  606.  
  607. The contents of a List File that is specified are included.  The contents of a
  608. List File specified after a -x are excluded.  Multiple List Files to be
  609. included and excluded may be specified on the command line in addition to file
  610. names being listed alone on the command line.
  611.  
  612. Following are several example usages of List Files, each with a short
  613. description of what action would be caused.
  614.  
  615.    C:\>pkzip first.zip @abc.lst -x@xyz.lst
  616.  
  617. All files specified in "abc.lst" would be added to the .ZIP file "first.zip".
  618. Any files that match the file specification in "xyz.lst" would not be added.
  619.  
  620.    C:\>pkzip second.zip -d @abc.lst -x*.txt
  621.  
  622. All files listed in "abc.lst" would be deleted from the .ZIP file "first.zip".
  623. Any files matching the "*.txt" specification would not be deleted.
  624.  
  625.    C:\>pkzip -vc third.zip @xyz.lst
  626.  
  627.  
  628.  
  629.  
  630.  
  631. ════════════════════════════════════════════════════════════════════════════
  632. 64                           Introduction                            PKZIP 2
  633.  
  634. A file listing with comments will be shown for all files in "third.zip" which
  635. are listed in "xyz.lst"
  636.  
  637.    C:\>pkzip -rp backup.zip *.* -x@noback.lst
  638.  
  639. A .ZIP file containing the entire drive would be created, excluding any files
  640. which match those in "noback.lst"
  641.  
  642. **  Don't forget to use the @ in front of a list file name.  If you do not use
  643.     the @, the list file itself will be added to the .ZIP file.
  644.  
  645. Generating List Files
  646.  
  647. The Generation of list files can have many uses.  Some suggested ways to use
  648. this feature are:
  649.  
  650. -> Dividing Files to be Zipped into logical groups
  651.  
  652. -> Easy exclusion of files already Zipped from a PKZIP operation
  653.  
  654. -> Complex Batch File operations
  655.  
  656. Keep in mind that a plain ASCII list file can be fed through other programs,
  657. like 'sort', and can be used by some other applications such as StupenDOS or
  658. PKZMENU.
  659.  
  660. The list file generated by PKZIP or PKUNZIP when the -@ option is used
  661. contains the names of all the files which would have been acted upon in a
  662. normal ZIP operation.
  663.  
  664. In a simple PKZIP command, the list file will contain a listing of all the
  665. files which would have been archived by PKZIP.  If the list file is generated
  666. with a freshen or update command, the list file will contain those files which
  667. would have been added/updated in the .ZIP file.
  668.  
  669. To generate a list file of your entire C: hard drive:
  670.  
  671.    C:\>pkzip dummy -rp -@cdrive.lst
  672.  
  673. Note that the "dummy" .ZIP file name is necessary to have a valid PKZIP
  674. command.
  675.  
  676. The list file generated by PKUNZIP will contain those files which would have
  677. been extracted.
  678.  
  679.  
  680.  
  681.  
  682.  
  683.  
  684.  
  685.  
  686.  
  687. ════════════════════════════════════════════════════════════════════════════
  688. PKWARE Inc.                  Using List Files                             65
  689.  
  690.  
  691. Using List files to debug
  692.  
  693. You may find the generation of list files helpful when you are testing batch
  694. files. Let's say you have created a batch file which should compress several
  695. files as a backup procedure.  Perhaps these files are very large and it takes
  696. several minutes to compress each one.  This means that if you were to test the
  697. batch file simply by running it, it could take quite a while to find a problem
  698. and fix it.
  699.  
  700. By generating a list file of what would have been compressed, you can check
  701. very quickly to make certain that the proper files are being selected.
  702.  
  703. List file size
  704.  
  705. The size of a list file that may be processed is limited.  The total size of
  706. the list file depends upon two factors.
  707.  
  708. The first is path storage.  If paths are specified in the list file and are
  709. NOT stored with the -P option, the list file size is limited to 7000 bytes.
  710.  
  711. If paths are specified and ARE stored, the list file size is limited to 9700
  712. bytes.
  713.  
  714. If a list file has drive letters specified as part of the file names within
  715. the file, the maximum list file size is reduced.  When paths are not stored
  716. the maximum List File size is 5100 bytes.  When they are stored the maximum
  717. List File size is 6600 bytes.
  718.  
  719. Note that this table corresponds to the total size of all list files being
  720. used in a single command.
  721.  
  722.       ╔════════════════════════════╤══════════════════╤═══════════════════╗
  723.       ║ List File Size Limits      │  No Path Storage │ Path Storage (-P) ║
  724.       ╟────────────────────────────┼──────────────────┼───────────────────╢
  725.       ║ Drive Letters in List File │    5100 bytes*   │       6600        ║
  726.       ╟────────────────────────────┼──────────────────┼───────────────────╢
  727.       ║ No Drive Letter            │       7000       │       9700        ║
  728.       ╚════════════════════════════╧══════════════════╧═══════════════════╝
  729.       *These numbers are approximate and may vary depending on your
  730.        configuration.
  731.  
  732. If the list file is too big, you will receive an "Insufficient Memory" error.
  733. If you have a list file which is too big, you may split it into two or more
  734. smaller list files and perform multiple PKZIP operations.
  735.  
  736.  
  737.  
  738.  
  739.  
  740.  
  741.  
  742.  
  743. ════════════════════════════════════════════════════════════════════════════
  744. 66                           Introduction                            PKZIP 2
  745.  
  746.  
  747. Be Creative
  748.  
  749. The list file functions give you a whole new level of power with PKZIP.  When
  750. defining a problem and searching for a solution, don't forget to consider the
  751. power of these features.
  752.  
  753. Using the list file features can give you access to new abilities PKZIP would
  754. not have inherently.  Here are some example situtations:
  755.  
  756. Removing Old Files
  757.  
  758. Suppose a .ZIP file 'work' contains 45 files.  The contents of 'work' are
  759. extracted to a work directory and several of the files are deleted.  How do
  760. you delete these files that are no longer necessary from the 'work' archive?
  761. Doing it manually would be very tedious.
  762.  
  763. First create a list of the contents of the directory.  By redirecting these
  764. file names to a list file you can capture an image of what needs to be kept in
  765. the .ZIP file.
  766.  
  767.    C:\work>pkzip dummy.zip *.* -@keep.lst
  768.  
  769. The list file 'keep.lst' now contains the files we want preserved in the .ZIP
  770. file, files not in this list will be deleted:
  771.  
  772.    C:\work>pkzip work.zip -d *.* -x@keep.lstC:\work>del keep.lst
  773.  
  774. The WORK.ZIP file now contains only those files which are also in the work
  775. directory.
  776.  
  777. Sorting .ZIP Files
  778.  
  779. Files will be added to a .ZIP file in the order that they are listed in the
  780. list file.  This can be useful if you want the contents of a .ZIP file to be
  781. in a particular order. After generating a list file, bring it into an editor
  782. and modify it to meet your need. To create a .ZIP file that is sorted in
  783. alphabetical order, you would use the following series of commands:
  784.  
  785.    C:\work>pkzip test.zip *.* -@test.lst
  786.    C:\work>sort < test.lst > sort.lst
  787.    C:\work>pkzip test.zip @sort.lst
  788.    C:\work>del test.lst sort.lst
  789.  
  790. The SORT command used above is a standard DOS program.  See your DOS
  791. manual for further information on this useful feature.
  792.  
  793.  
  794.  
  795.  
  796.  
  797.  
  798.  
  799. ════════════════════════════════════════════════════════════════════════════
  800. PKWARE Inc.                  Using List Files                             67
  801.  
  802. USING DATA ENCRYPTION
  803. ════════════════════════════════════════════════════════════════════════════
  804.  
  805. The PKZIP utilities offer the ability to protect stored data through
  806. encryption.  You should use PKZIP's encryption ability in place of any other
  807. encryption on files you intend to compress.
  808.  
  809. This encryption ability has been made integral to the function of PKZIP and
  810. PKUNZIP to prevent the encryption from interfering with PKZIP's ability to
  811. compress. If you feel the need to encrypt your data to protect it, and are
  812. intending to compress the data as well, you should then use the encryption of
  813. PKZIP.  Using the encryption capability of a spreadsheet or database program
  814. will prevent PKZIP from compressing the data efficiently.
  815.  
  816. Encryption is enabled in PKZIP by use of the -s option.  The encryption key,
  817. sometimes referred to as a "password", follows directly after the -s
  818.  
  819.    C:\>pkzip test.zip -ssecret d:\payroll\*.dbf
  820.  
  821. Above, all the "dbf" files from the payroll directory have been compressed
  822. into a .ZIP file called "test.zip".  During the compression they are also
  823. being encrypted based upon the key of "secret".
  824.  
  825. The encryption scheme used by PKZIP is complex and robust.  The encryption key
  826. is used to generate a number of binary encryption keys which are in turn used
  827. to determine how the compressed data is altered.  Neither the original key or
  828. the derived keys are stored with the .ZIP file, nor are they retained anywhere
  829. else for that matter.  This means you must remember the encryption key.
  830.  
  831.  
  832.      ╔═══════════════════════════════════════════════════════════════════╗
  833.      ║ IF YOU LOSE THE ORIGINAL ENCRYPTION KEY YOU WILL NEVER BE ABLE TO ║
  834.      ║ EXTRACT THE FILE(S).                                              ║
  835.      ╚═══════════════════════════════════════════════════════════════════╝
  836.  
  837.  
  838. It is also not possible to derive the original keys by examining the
  839. compressed data, or by analysis of original data versus encrypted data.  This
  840. means that if you loose the key, there is no way to find it.  PKWARE Inc. has
  841. no special means or technology for deriving the key or extracting the data
  842. without the key.
  843.  
  844. Also note that a minute change in the key completely alters the encryption
  845. scheme.  This means that the key must be exact.  Any change in spelling,
  846. capitalization or punctuation causes a key to be completely different.  Be
  847. certain that you know what the encryption key is and will not lose, forget, or
  848. mistype it.
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855. ════════════════════════════════════════════════════════════════════════════
  856. 68                           Introduction                            PKZIP 2
  857.  
  858.           ╔════════════════════════════════════════════════╗
  859.           ║ DO NOT TRUST YOUR MEMORY ALONE.  WRITE IT DOWN.║
  860.           ╚════════════════════════════════════════════════╝
  861.  
  862. Capitalization is also important.  "Secret", "secret" and "SECRET" are all
  863. completely different encryption keys.
  864. You should realize that a person who knows you could attempt to extract a file
  865. you have encrypted by using words they think you will use or can remember
  866. easily.  This would be items such as:
  867.  
  868.   ≡ Your Spouse's name
  869.  
  870.   ≡ Your Social Security Number
  871.  
  872.   ≡ Your Address
  873.  
  874.   ≡ Your Dog's name
  875.  
  876.   ≡ Etc...
  877.  
  878. Long Keys
  879.  
  880. It is possible to have extremely long keys, or keys with spaces in them.  The
  881. length of the encryption key is limited only by the length of a DOS command
  882. line. To use a key with spaces in it, you must enclose the password in
  883. quotation marks:
  884.  
  885.    C:\>pkzip test.zip -s"mary had a little lamb" *.dbf
  886.  
  887. Passwords of this sort may be easy to remember, while proving to be very
  888. secure. Remember to use phrases that are not obvious to someone who knows you.
  889.  
  890. Complex Keys
  891.  
  892. If PKZIP or PKUNZIP is specified with only the -s and no encryption key
  893. following, the user is prompted for an encryption key.
  894.  
  895.  
  896.  
  897.  
  898.  
  899.  
  900.  
  901.  
  902.  
  903.  
  904.  
  905.  
  906.  
  907.  
  908.  
  909.  
  910.  
  911. ════════════════════════════════════════════════════════════════════════════
  912. PKWARE Inc.                 Using Data Encryption                         69
  913.  
  914.    C:\>zip test -s *.com
  915.  
  916.    PKZIP (R)  FAST!  Create/Update Utility  Version 2
  917.    Copr. 1989-1992 PKWARE Inc.  All Rights Reserved.  PKZIP/h for help
  918.    PKZIP Reg. U.S. Pat. and Tm. Off.   Patent No. 5,051,745
  919.  
  920.    Password ? ******
  921.  
  922.    ■80486 CPU detected.
  923.    ■XMS version 2.00 detected.
  924.    ■Novell Netware version 3.11 detected.
  925.    ■Using Super Fast Compression.
  926.  
  927.    Creating ZIP: TEST.ZIP
  928.    Adding: COMMAND.COM  Deflating (36%), done.
  929.    Adding: 4DOS.COM     Deflating (34%), done.
  930.  
  931. Asterisks are displayed in place of each character as you enter the encryption
  932. key.  This feature offers added security in the event somone is watching as
  933. you type in the password.
  934.  
  935. This method of entry may be easier or more comfortable to use.  This also
  936. allows you to enter characters for the encryption key which cannot normally be
  937. entered from the keyboard.
  938.  
  939. In order to enter one of these characters, hold down the [ALT]